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PREFACE 

• j 

j This  report  is  the  result  of  work  performed  under  Contract  No. 

i DACA39-78-M-0053,  dated  25  January  1978,  hetween  the  U.  S.  Army  Engineer 

t 

5 Watejrways  Experiment  Station  (WES),  Vicksburg,  Miss.,  and  the  author. 

Dr.  Richeird  F.  Puk,  Graphics  Consulteuit.  The  work  concerned  designing 
5 device  implementation  guidelines  for  the  three-dimensional  version 

'■  (2.0)  of  the  Graphics  Compatibility  System  (GCS).  The  task  was  directed 

by  the  Automatic  Data  Processing  (ADP)  Center,  WES,  as  part' of  the  Inte- 
■;  grated  Software  Research  and  Development  Program,  ATll,  Engineering 

' Software  Research,  Graphics  Interfaces  for  Scientific  Applications,  Im- 

provement and  Refinement  of  Computer  Graphics  Software  Package,  sponsored 
by  the  Office,  Chief  of  Engineers,  U.  S.  Army. 

Mr.  James  M.  Jones  II,  R&D  Software  Group,  ADP  Center,  WES,  ■ 
monitored  the  contract  under  the  general  supervision  of  Dr.  N.  Radhakrishnan, 
Special  Technical  Assistant  to  the  Chief  of  the  ADP  Center,  and  Mr.  D.  L. 
Neumann,  Chief  of  the  ADP  Center. 


Director  of  WES  dxiring  the  period  of  the  contract  was  COL  J.  L. 
Cannon,  CE.  Technical  Director  was  Mr.  F.  R.  Brown. 
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DEVICE  IMPLEMESTATION  GUIDELINES  FOR  THE  THREE- 
DIMEHSIOIIAL  GRAPHICS  COMPATIBILITY  SYSTBt  (GCS) 


I,  Introduction. 

Ilia  following  paragraphs  develop  guidelines  for  Imple- 
menting new  devices  for  3-1)  GCS.  Included  will  be  the 
definition  of  device-dependent  Graphics  Status  Area  Initial- 
ization values,  functional  specifications  for  each  of  the 
3-D  GCS  device-dependent  routines,  a discussion  of  factors 
involved  In  supporting  Intelligent  refresh  devices,  and  a 
description  of  a phased  sequence  for  Implementing  new 
devices. 

II.  Graphics  Status  Area  Initialization. 


In  this  section,  each  of  the  device-dependent  elements 

of  the  Graphics  Status  Area  (GSA)  will  be  listed  along  with 

the  procedures  required  to  calculate  the  value.  If  appropriate. 

K3EAMX  Logical  pen  x-posltlon  In  raster  units.  Default 

position  Is  lower  left  corner  of  the  largest  square 
on  plotting  surface.  If  screen  Is  rectangular,  the 
square  la  right-  or  bottom-justified. 

OEAMY  Logical  pen  y-posltlon  In  raster  units.  Default 

position  Is  lower  left  corner  of  the  largest  square 
on  the  plotting  surface.  If  the  screen  Is  rectangular, 
the  square  Is  right-  or  bottom- Justified. 

KBEAMZ  Logical  pen  z-posltlon.  Default  value  Is  zero. 

TRSVX  Ratio  of  screen  to  virtual  units  In  z-dlrectlon. 

Default  Is  width  of  UDAREA  In  raster  units  divided 
by  width  of  DWINDO  (100.). 

TRSVY  Ratio  of  screen  to  virtual  units  In  y-dlrectlon. 

Default  Is  height  of  ITDAREA  In  raster  units  divided 
by  height  of  UVfINDO  (100.). 

KMIESX  Minimum  x screen  window  (UDAREA)  boundary  In  raster 
units.  Default  Is  the  same  as  KBEAMX. 

KMAX3X  Maximum  x screen  window  (UDAREA)  boundary  In  raster 
units.  Default  Is  maximum  address  In  x-dlrectlon. 

KMIHSY  Minimum  y screen  window  (UDAREA)  boundary  In  raster 
units.  Default  Is  same  as  KBEAMY. 

XMAX3Y  Maximum  y screen  window  (UDAREA)  boundary  In  raster 

units.  Default  Is  the  top  boundary  of  largest  square 
in  plotting  surface. 
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KMINSZ  MlnifflUffl  z scrsen  vindov  (UDAR2A)  boundary  in 
raster  units.  Default  is  sane  as  KBEAMZ. 

KM&XSZ  Haxlmiua  z screen  window  (ODAREl)  boundary  in 

raster  units.  Default  is  the  baok  plane  of  the 
cubical  display  voluae  for  3S  devices.  For  2D 
devices,  the  default  is  the  same  as  KMiXSX. 

KCOLOR  Color  or  greyscale  switch.  Default  is  the  actual 
color  produced  by  the  plct  head  >Aen  device  is 
initialized. 

TNRKSZ  Marker  horizontal  size  in  raster  units.  Default 
is  one  per  cent  of  the  maximum  physical  x address 
but  no  smaller  than  one. 

KHORSZ  Horizontal  hardware  character  position  size  in 

raster  units.  Default  is  width  of  smallest  size 
character  position. 

KVERSZ  Vertical  hardware  character  position  size  in  raster 
units.  Default  value  is  height  of  smallest  size 
character  position. 

ELMRGN  Left  alphanumeric  margin  boundary  in  raster  units. 

Default  is  normally  zero  (minimum  plotting  surface 
address  in  x-dlrectlon). 

KRMRGN  Right  alphanumeric  margin  boundary  in  raster  units. 
Default  is  maximum  plotting  surface  address  in 
x«dlrection. 

KIMRGN  Top  alphanumeric  margin  boundary  in  raster  units. 
Default  is  maximum  plottizig  surface  address  in 
y-dlrectlon. 

KBMRGN  Bottom  alphanumeric  margin  boundary  in  raster  units. 

Default  is  zero  (minimum  plotting  surface  address  in 
y>dlrection}. 

KG IN  Graphics  input  device  selector.  Default  is  primary 

graphics  input  device  cn  display. 

KMINHX  Minimum  device  x-bcundary  of  last  NEWSCALB.  Default 
is  KMINSX. 

KMAXHX  Maximum  device  x-boundary  of  last  NEWSCALE.  Default 
is  KMAXSX. 

EMIHHT  Minimum  devios  y-boundary  of  last  NEVfSCALE.  Default 
is  KMINSY. 

KMAXHT  Maximum  device  y-boundary  of  last  NEWSCALE.  Default 
is  KMAXST. 
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SMIHCX  Hlnlfflum  z-address  of  display  surface  in  raster  units. 
Default  Is  zero. 

KMAXOX  Maximum  z-address  of  display  surface  In  raster  units. 

Default  for  devices  with  variable  size  plotting  surface 
Is  largest  square  using  normal  plotting  medium. 

KMIHDX  Minimum  y-address  of  display  surface  In  raster  units. 
Default  Is  zero. 

KMAXDY  Maximum  y-address  of  display  surface  In  'raster  units. 

Default  for  devices  with  variable  size  plotting  surface 
Is  largest  square  using  normal  plotting  medium. 

EMIMDZ  Minimum  z-address  of  display  surface  In  raster  units. 
Default  Is  zero. 


KMAXDZ  Maximum  z-address  of  display  surface  In  raster  units. 
Default  Is  same  as  KMAJCDX. 

TEiSTX  X-resolutlon  In  raster  units  per  Inch.  Default  Is 

XMAXDX  divided  by  width  of  plotting  surface  In  Inches. 

I&ASIY  Y-resolutlon  In  raster  units  per  Inch.  Default  Is 

KMAXDY  divided  by  height  of  plotting  surface  In  Inches. 

IHASIZ  Z-resolutlon  In  raster  units  per  Inch.  Default  Is 

KMAXDZ  divided  by  depth  of  plotting  stirface  In  Inches 
(or  width  If  2D  device). 

K?MXMX  Formatted  display  surface  z-dlmenslon  In  raster  units. 
Default  Is  maximum  normal  x-dlmenslon. 

KFMYMX  Formatted  display  surface  y-dlmenslon  In  raster  units. 
Default  Is  maximum  normal  y-dlmenslon. 

KFMZMX  Formatted  display  surface  z-dlmenslon  In  raster  units. 

Default  Is  maximum  normal  z-dlmenslon . (same  as  KFMXMX 
for  2D  devices). 

THDCPY  Hard  copy  delay  time  In  seconds.  Default  Is  the 

number  of  seconds  of  wait  time  required  while  a hard 
copy  Is  being  generated.  Default  Is  zero  If  no  hard 
copy  capability  Is  available. 

KPHXMX  Maximum  possible  physical  z-boundary  In  raster  units. 
Default  Is  largest  possible  address.  This  could 
Include  a full  roll  of  plotter  paper. 

KFHYMX  Maximum  possible  physical  y-boundary  In  raster  units. 
Default  la  largest  possible  y-address. 

KFHZMX  Maximum  possible  physical  z-boundary  In  raster  units. 

Default  Is  largest  possible  z-address  (same  as  KPHXMX 
for  2D  devices). 
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TRSSOX  Actual  physical  x>resolutlon. in  raster  units  per 

inch.  Default  is  SPHXMX  divided  by  actual  width  of 
display  surface  in  inches. 

TRSSOX  Actual  physical  y-resolution  in  raster  units  per 
inch.  Default  is  KPHYMX  divided  by  actual  height 
of  display  surface  in  inches. 

TRESOZ  Actual  physical  z-resolution  in  raster  units  per 
inch.  Default  is  KPHZHX  divided  by  actual  depth 
of  display  surface  in  inches  (actual  width  is  used 
for  2D  devices). 

ETYMNU  Device  type  for  menu  generation.  Possible  values 

are:  Graphics  device  = 1.  Alphanumeric  device  s 2, 
Batch  device  =3. 

ERRCLR  Number  of  modifiable  color  table  entries  supported. 

Default  is  zero  for  devices  which  have  no  modifiable 
color  table. 

EBAUDR  Speed  of  communication  line  in  characters  per  second. 
Default  is  usual  speed  for  device. 

KPCHAR  X«Y  component  buffer.  Used  by  G0SF5N  as  a work  area. 
Default  should  reflect  impossible  or  unusable  value. 

KPRSVC  Color  which  terminal  is  currently  generating.  Default 
is  same  as  KCOLOR. 

KPRSVI  Current  device  intensity  setting. . Default  is  set  to 
sixty  percent  of  maximum  screen  intensity. 
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5-D  GCS  Device-Dependent  Routines* 


This  section  describes  the  functions  embodied  In  each 
of  the  3>D  GCS  device-dependent  routines.  This  discussion 
will  Include  Interface  specifications,  functional  specifi- 
cations, and  Indication  of  whether  the  function  can  be 
supported  at  the  display-device  either  In  hardware  or  soft- 
ware, relationships  to  other  functions,  and  special  Instruc- 
tions which  may  be  required  for  3-'0  display-devices.  The 
functions  will  be  listed  alphabetically  within  the  two 
groups,  user-interface  and  GCS-lnternal. 


OHDOPy 


Oonunents: 


This  routine  causes  a hard  copy  of  the  current 
display  surface  to  be  produced  If  an  on-line 
loinedlate  hard  copy  facility  Is  available  for 
the  display  device.  A delay  can  be  programmed 
by  checking  the  GSA  variable  THDOPT  which  Indicates 
the  number  of  seconds  of  delay  required.  The 
delay  can  be  generated  by  sending  an  appropriate 
number  of  'NUL'  or  'SYN*  characters  to  the  display 
device  based  on  TSDCFY  seconds  times'  the  contents 
of  KBAtlDR  (communication  line  speed  In  characters 
per  second } . 

This  function  Is  null  for  display  devices  with  no 
on-line  immediate  hard  copy  capability. 


DRSBT 


Oomfflentst 


Thla  routine  returns  the  Graphics  Status  Area 
to  Its  Initial  condition.  Aside  from  setting 
the  device-dependent  GSA  elements  to  agree  with 
those  In  the  Block  Data  subroutine  for  this 
device  before  compllatlont  no  further  modification 
Is  required. 

This  routine  can  not  be  supported  at  .the  dlspla7- 
devloe. 


UWIIT(TINB) 

TIME  indlc*.t«8  the  amount  of  time  which  GCS  will 
wait  before  eendlng  fiu'ther  commande  to  the 
dleplay* 

Oommentet  Thle  routine  le  ueually  Implemented  by  eendlng 
a eufflclent  niunber  of  null-operation  control 
charaotere  acrose  the  communication  line  to 
oauee  the  required  delay. 

The  KBAnSR  GSA  element  specifies  the  line  speed 
In  characters  per  second.  For  batch  devices, 
this  routine  Is  a null-operation. 

This  routine  cannot  be  supported  at  the  display. 
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GCSALT-tlCHAR ) 

lOHAR  Is  one  ASCII  character,  right- justified , 
zero-fill. 

Oonunents:  This  routine  causes  one  hardware  character  to  be 
displayed  after  the  terminal  is  placed  in  alpha 
mode  and  KOOSE  is  set  to  reflect  alpha  mode.  If 
a hardware  character  generator  is  not  available 
and  if  the  device  is  not  intelligent,,  a devlce- 
indpendent  hardware  character  simulator  version 
of  GCSAX?  is  available.  If  a hardware  character 
generator  or  simulator  is  available  at  the 
display,  the  printable  character  is  simply  sent 
to  the  display.  Note  that  on  three-dimensional 
devices,  the  characters  are  always  produced  on 
the  screen  plane.  Only  printable  ASCII  characters 
are  output  from  this  routine.  The  receipt  of 
control  characters  Implies  that  the  terminAlj.is 
is  to  be  placed  in  alpha  mode  and  that  the  char- 
acter size  is  to  be  updated,  if  necessary. 

Two  control  characters  have  special  extra  meaning 

for  intelligent  displays.  A value  of  001s  indicates  | 

start  of  alpha  string  and  0028  indicates  end  of 
alpha  string.  This  allows  strings  of  characters 
to  be  processed  as  one  primitive  operation  at  the 
display. 

To  update  the  character  size,  on  input  the  value  of 
KSIZEF  is  stored  in  KFREVS  and  the  new  sizes  are 
stored  in  KHORSZ  and  K7ERSZ. 

This  function  may  be  supported  at  an  intelligent 
display-device  either  by  sending  single  characters 
or  be  using  the  001 3 and  0028  brackets  to  send 
entire  character  strings. 
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GCSARC (X , T .AHGLS .RADIUS , ICHBCK ) 


X.Y  are  the  coordinates  of  the  center  of  the  circle 
defined  by  the  arc. 

ANGLB  Indicates  the  angle  the  arc  will  subtend  and 
the  direction  of  travel  of  the  arc.  A posi- 
tive angle  Is  counterclockwise,  a negative 
angle  Is  olookwlse. 

RADIUS  specifies  the  radius  of  the  olrcle. 

ICHECK  Is  set  to  1 If  hardware  arc  generation  Is  not 
available  or  the  arc  was  not  drawn  for  this 
request.  It  Is  set  to  zero  If  the  requested 
arc  was  drawn. 

Conunents:  If  hardware  are  generation  Is  available  and  If 
the  arc  can  be  drawn  and  does  not  Intersect  the 
window,  the  flag  ICHECK  Is  set  to  zero  and  the 
appropriate  Instruction  Is  sent  to  the  display. 

If.  for  some  reason,  the  arc  can  not  be  drawn  at 
the  display,  the  flag  Is  set  to  1 . Reasons  which 
might  apply  are  lack  of  an  arc  generation  facility 
at  the  display  device.  Intersection  of  the  arc 
with  the  window,  or  the  viewing  and  positional 
transformations  are  such  that  the  arc  cannot  be 
drawn  In  the  current  X.Y  plane  by  the  hardware. 

This  function  may  be  supported  at  the  device  If 
the  arc  to  be  drawn  does  not  Intersect  the  window. 

If  It  does  Intersect  the  window.  GCSARC  may 
calculate  the  visible  arc  segments  and  Issue 
several  Instructions  to  draw  each  segment.  However, 
the  Instructions  to  perform  these  calculations  are 
somewhat  complex  and  It  Is  usually  left  to  UARC 
to  draw  the  desired  arc. 
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Thia  routine  parforna  any  Initlallaatlon 
functions  required  by  the  display*  For 
Intelligent  devices*  It  may  pass  the  Initial* 
Izatlon  request  to  the  device.  For  3-1) 
display-devices*  It  may  have  to  Initially 
load  the  viewing  transform  parameters  to  their 
default  values. 


} 
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GCSBFKdX.IY.ICHAR} 

IX, I Y la  the  location  to  be  marked. 

ICHAB  la  the  fill  character  for  the  dealgnated 
raater  poaltion.  For  aome  raater  de^lcea, 
thla  argument  may  be  uaed  to  indicate  the 
number  of  raater  positiona  along  the  raater 
to  be  marked  starting  at  the  indicated  raater 
position. 

Comments:  This  routine  maintains  the  internal  raster  buffer 
for  raster  devices  such  as  line  printers,  alpha* 
numeric  terminals  without  cursor  addressing,  and 
direct  support  of  electrostatic  printers.  The 
buffer  is  a Fortran  Common  Area  GCSBUF  which 
contains  storage  for  the  entire  frame  or  a page 
of  the  frame.  The  IX, lY  values  are  mapped  into 
buffer  locations  and  the  character  (after  trans- 
lation into  internal  computer  character  set)  or 
raster  positions  are  stored  there. 

This  routine  may  be  supported  at  the  display- 
device  if  an  intelligent  raster-scan  terminal 
or  an  unintelligent  raster-scan  terminal  with 
local  raster  storage.  In  this  case,  this  routine 
should  be  eliminated  with  CCSFEN  sending  the 
vector  request  directly  to  the  terminal.  This 
will  require  implementation  of  the  scan  conversion 
at  the  terminal  either  in  hardware  or  software. 


GOSOLR  ( I1ISSX , OLRVSO ) 
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nsiX  Is  the  color  table  entry  being  defined. 

OLRVSO  is  an  array  of  seven  elements.  Baoh  element 

Indicates  a percentage  of  maximum  participation 
for  a particular  hue.  Basic  hues  are  In  the 
order:  RID.  GRSSN,  TSLLOtf.  BLUR.  MAGBRTA.  OYAH. 
and  WHITS. 

Oomments:  This  routine  allows  redefinition  of  coldr  table 

entries  for  display  devices  supporting  a modifiable 
color  table.  For  all  other  devices,  this  routine 
Is  null. 

If  IHDSX  exceeds  the  maximum  color  table  Index, 
the  value  of  INDEX  modulo  the  number  of  color 
table  entries  available  should  be  used. 

Since  the  values  in  CLRVSO  represent  percentages 
of  the  maximum  participation  for  a particular 
basic  hue,  they  can  also  be  thought  of  as  percent- 
ages of  maximum  Intensity.  The  actual  Intensity 
value  for  the  hue  can  be  obtained  by  multiplying 
the  maximum  Intensity  setting  by  the  CLRVSC  entry 
divided  by  100.  Note  that  If  only  a three  entry 
color  table  Is  available  (red.-  blue,  green;  or 
magenta,  yellow,  cyan),  the  complementary  hues 
may  be  obtained  from  the  appropriate  components 
each  of  which  has  the  intensity  setting  desired 
for  the  unavailable  hue.  For  example,  75^  yellow 
may  be  obtained  on  additive  color  systems  from 
755*  red  and  75^  green. 
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GOSOLS 

Conmants:  This  routine  oloaes  the  currently  open  segment 
at  the  display  device.  Note  that  If  the  device 
draws  vectors  or  characters  by  soma  kind  of 
vector  string  or  character  string,  this  string 
should  be  terminated  prior  to  closing  the  segment. 
Failure  to  do  this  when  required  can  cause  mls- 
! Interpreted  Information  to  be  displayed  when  the 

segments  are  being  posted, 
i 

i 
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GOSOSKNlNSaG) 


NAlfSSG  Is  the  number  of  the  segment  to  be  deleted. 

Oomments:  This  routine  sends  a command  to  the  display 

device  causing  the  requested  segment  to  be  deleted. 
Tor  display  devices  which  have  no  Inherent  seg- 
mentation capability  or  requirement,  the  deletion 
Is  handled  entirely  by  USSLEI  and  this  routine  Is 
null.  If  VAMSBG  has  value  zero,  all. segments  are 
to  be  deleted. 

Hote  htat  when  the  delete  Is  requested  at  the 
display  device,  the  deleteion  should  occur  Immedi- 
ately (1.  e.,  the  segment  should  be  removed  from 
the  display  surface. 
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GCSOSP 

OomiMnts:  This  routine  tranemlte  the  ueer  dlepley  area 

location  to  the  displaj-deTice.  This  will  only 
be  required  for  3-D  devices  which  perforin  the 
viewing  transform  and  clipping  at  the  display- 
device* 
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Gossn) 


OooflMntst  This  routine  perforos  any  termination  functions 
required  by  the  dlsplay-devloe*  ?or  Intelligent 
devices.  It  may  pass  the  termination  request  to 
the  device. 
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GOSERl 

Oonmants:  This  routine  provides  a olean  plotting  surface  by 

either  erasing  the  plotting  surface  or  by  advancing 
the  plotting  medium  to  an  unused  frame. 

This  function  may  be  supported  at  the  display-device. 
In  this  case,  only  an  Indication  that  the  erase  must 
occur  need  be  transmitted  to  the  device. 

Note:  In  earlier  versions  of  GCS,  this  fimctlon 
was  Incorporated  within  a device-dependent  U2RASE. 
USELA.se  has  been  made  device-independent.  It  now 
calls  GCSSILA.  to  actually  perform  the  erasure. 


G0S7HT  ( INCBX , ASPSOT  .VTISTH } 

IfiSSX  Is  the  GCS  index  number  for  the  supported 
format  type.  A listing  of  the  formats 
supported  may  be  found  in  UPORMT. 

ASPECT  is  the  aspect  ratio  of  the  requested  format. 

WIDTH  is  the  width  of  the  format  in  inches. 

Comments:  This  routine  corrects  the  display  surface  format 
boundaries  established  by  UPORMT.  Since  UPORMT 
centers  the  format  on  the  physical  display  surface 
boundaries,  no  other  action  is  required  if  that 
position  is  appropriate  for  the  requested  format. 
This  routine  will  only  be  different  from  the  null 
function  for  devices  with  variable  size  plctting 
surfaces  such  as  computer-output-micro film  (COM; 
recorders  or  pen  plotters. 

Por  COM  recorders,  the  appropriate  formats  should 
be  mapped  onto  the  address  space  in  such  a way 
that  when  the  COM  device  is  configured  with  the 
camera/lens  combination  for  the  requested  format, 
the  format  boundaries  exactly  match  the  edges  of 
the  frame  on  the  film. 

Por  pen  plotters,  paper  (or  other  medium)  of  the 
appropriate  size  is  requested  to  be  made  ready  on 
the  plotter  surface. 

If  INDEX  has  value  zero,  GCSPMT  will  have  been 
invoked  by  UDIMEN.  In  this  case,  adjustments  as 
necessary  to  support  the  requested  aspect  ratio 
and  width  should  be  made. 
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GCS7R1 ( INDEX , OPCODE ) 


INDEX  is  the  numeric  identifier  for  the  frame. 

OPCODE  is  the  action  to  be  performed  related  to 
the  designated  frame. 

Comments:  This  routine  processes  the  frame  manipulation 
function  requests  of  "open",  "oloee",  "show", 
and  "unshow".  Since  these  operations  are 
currentlj  supported  only  in  an  intelligent 
display,  this  function  becomes  a null  ronitine 
for  unintelligent  devices.  The  function  of 
this  routine  is  primarily  to  reformat  the 
requested  operation  as  necessary  and  transmit 
it  to  the  display. 

This  is  an  interface  routine  which  communicates 
with  a program  executing  in  the  display-device 
general  processor  if  the  display  is  intelligent. 


1 1 


GOSIM ( lOOUNT , IB DP , IPRMPT ) 

lOODNI  indicates  the  upper  limit  of  the  number  of  ISCII 
characters  to  be  received  as  input. 

IHBDP  is  a buffer  of  length  ICODNT  in  which  the  ASOII 
characters  will  be  placed  right- justified, 
zero-fill. 

IPRMPT  is  an  arraj  containing  the  number  of  prompt 

characters  to  be  produced  in  the  first  word  and 
the  prompt  characters  in  the  succeeding  words, 
one  ASCII  character/word,  right- Justif led , 
zero’-fill. 

Comments:  This  is  primarll7  in  interface  routine  to  the 
operating  system  function  which  actually  sends 
the  prompt  and  obtains  the  characters.  If  less 
than  ICODNT  characters  are  received,  the  remaining 
buffer  positions  should  be  zeroed. 

This  function  can  not  be  supported  at  the  display 
device  since  it  is  really  not  device-dependent 
but  operating  system  dependent.  However,  to 
insure  correct  linkage  editing  on  all-  operating 
systems,  it  is  grouped  with  the  device-dependent 
routines.  Note  that  on  many  operating  systems, 
a routine  has  been  written  to  perform  this  function 
(see  3D  GCS  Host-Computer  Implementation  Guidelines). 

Por  batch  devices,  this  routine  issues  an  error 
message  ^nd  returns  null  characters. 

If  the  operating  system  routine  does  not  handle 
piompts,  the  prompt  may  be  generated  by  the 
following  statements  prior  to  calling  the  operating 
system  input  routine: 

IPRAMBsKPRAME 

KFRAMEsO 

CALL  GCSODT ( IPRMPT ( 1 ) , IPRMPT ( 2 ) , 0 ) 
KPRAMB=IPRAMB 
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GCS IHH (ICOUHT , ISTBHG ) 

ICOUNT  indicates  the  ntunber  of  ISOII  oharaotsrs  to 
bs  road  from  the  terminal* 

ISTBNG  is  a buffer  into  which  ICOUVT  oharaoters  will 
be  placed* 

Oommente:  This  routine  aocepte  strings  of  ASCII  oharaoters 
from  the  terminal*  Priop  to  issuing  an  input 
operation  using  GCSIN,  the  terminal  is  placed  in 
the  appropriate  mode  to  aotiTate  the  logical  tazt 
device y usually  realized  as  a keyboard*  If 
ICOUNT  is  less  than  or  equal  to  zero*  no  input 
operation  takes  place* 

This  function  can  not  be  supported  at  the  display. 


G03M1P  (XIH  ,TIH  .ZIM  ,XOUT , XOITT  ,ZOUT ) 

XI]f,YIN,ZIN  are  the  coordinate*  before  projection 
in  viewing  unite* 

XOUT»yCUT*ZOUT  are  the  coordinate*  after  projeoition 
is  appl.ied  in  viewing  tmita. 

Oommente:  This  routine  performs  orthogonal  or  psrspeotivs 
transformations  for  devices  which  do  not  perform 
viewing  transformations  at  the  display-device. 

In  this  case,  a version  of  this  routine -is 
provided.  For  devices  which  do  perform  the  view- 
ing transformation  at  the  display-device,  this 
routine  consists  simply  of  the  input  coordinates 
mapping  into  the  output  coordinates. 


GCSMOD  (NJLM3EG  ,NAHiI  »MSWAL , ILOO } 
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NAM5B&  is  the  number  of  the  segment  one  of  whose 
attributes  Is  to  be  modified. 

NAMA.I  is  the  number  of  the  attribute  to  be  modified: 

0 = Visibility 

1 = Highlighting 

2 s Deteotibility 

3 = 2D  Translate  Image  Transformation 

4 5 21)  General  Image  Transformation 

5 = 3D  Translate  Image  Tremsformation 

6 = 3D  General  Image  Transformation 

NSHVAL  contains  the  new  setting  for  the  attribute  of 
the  specified  segment.  If  NAMA.T  has  values 
0-2,  NEVrVAL  will  have  values  0 = OP?  or 
1 = ON.  Otherwise,  NBVTVAL  is  an  array  con- 
taining the  parameters  for  the  image  trans- 
formation requested. 

ILOC  is  the  record  number  within  the  GCS  library 
work  file  where  the  segment  is  located  if 
segmentation  is  occurring  entirely  in  the 
host-computer. 

Comments:  This,  routine  causes  the  indicated  segment  attri- 
bute to  be  modified  as  directed  at  the  display 
device.  Highlighting  should  be  supported  by 
blinking  whenever  possible. 

For  devices  which  support  segmentation  at  the 
display  device,  this  routine  sends  the  requested 
segment  attribute  modifications  to  the  display 
device.  Note  that  if  the  device  does  not  support 
image  transformations  at  a particular  level, 
requests  for  such  transforms  should  not  be  sent 
but  ignored  or  processed  as  well  as  possible. 

For  other  devices,  segmentation  is  supported  within 
the  host  by  saving  the  segments  in  the  library  work 
file.  The  segment  attributes  are  contained  in  the 
segment  table  which  is  inaccessible  to  the  device- 
dependent routines.  However,  the  current  image 
transformation  is  stored  in  the  segment  header  as 
follows: 

Header  Word  5 indicates  the  number  of  words 
in  the  segment  header  exten- 
sion in  which  are  stored  the 
transformation. 

Header  Word  6 and  the  following  words,  if 

required,  contain  the  current 
image  transformation. 


26 


I 


GCSMOO  (eont. ) 

If  the  current  appearance  cf  the  segaent  la 
changed  by  the  attribute  aodificationt  then  the 
display  surface  must  be  updated  tc  reflect  the 
chazige  unless  posting  modifications  Is  belxig 
delayed  (EPOST  .2Q.  0). 
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aOSMRX ( ISX , INT, IHZ , INABE ) 

IHZ«I]!n,IlfZ  Is  the  location  of  the  marker  (symbol)  in 
raster  units. 

IMiRK  Is  the  number  of  the  marker  to  be  generated. 

Comments:  This  routine  produces  a marker  at  the  Indicated 
location  In  raster  units.  At  least  ten  markers 
are  supported  by  GCS.  Marker  0 Is  always  a 
point  and  calling  GCSMRS  with  IHARE  ^SQ.  0 will 
result  In  point  plotting  and  should  generate 
point  plotting  display  commands  If  they  are 
available.  If  markers  are  not  supported  at  the 
display  device,  the  markers  are  simulated  by  using 
GOSSIM.  Descriptors  of  the  markers  have  been 
defined  for  Input  to  GCSSIH.  This  version  of 
GOSMRK  exists  In  cvirrent  device  libraries.  Mote 
tliat.  even  In  this  case.  IMARE  .RQ.  0 Is  produced 
by  the  special  call  to  GCSFSN  with  IFEN  .£Q.  2. 

If  markers  are  supported  at  the  display  device, 
then  commands  should  be  generated  which  will 
produce  the  requested  markers  at  the  Indicated 
location. 

If  IMARE  exceeds  the  highest  marker  Index,  an  IMARE 
modulo  the  number  of  markers  available  Is  used. 
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GOSOPV (NAMSSG .HHTSfiG , ILOO ) 

SIMSSG  is  the  number  of  the  segment  to  be  opened. 

NBTSSG  are  the  initial  segment  attribute  settings 
as  follows: 


Visibility 

fiighlighting 

Deteotibility 


1 OsOPP 
rj  1 =0N 


Comments: 


is  the  number  of  a record  on  the  GCS  library 
work  file  in  which  the  segment  can  be  stored 
if  the  display  device  does  not  have  inherent 
segmentation  capability. 

This  routine  opens  the  requested  segment  at  the 
display  device.  Before  a segment  is  opened,  any 
vector  or  character  strings  which  are  currently 
being  processed  must  be  terminated  to  avoid 
problems  during  posting. 

If  segmentation  is  maintained  at  the  display 
device,  an  "open  segment"  command  should  be  sent 
to  the  device  along  with  the  initial  segment 
attributes. 

If  segmentation  is  being  handled  within  the  host- 
computer,  the  segment  header  must  be  initialized. 
The  segment  header  is  located  in  the  first  words 
of  the  first  record  of  the  segment  and  has  the 
following  format: 


Index  of  first  primitive  in 
this  segment  block 

Index  of  last  word  in  this 
segment  block 

Count  of  bytes  in  last  word 

Link  to  continuation  block  |C 
(0  means  none  assigned)  IP 
Size  of  image  transformation 
header  extension 

Image  Transformation 
Header  Extension 
(0  size  9)  words 


always  poihts  to 
[beginning  of  data 


‘Continuation  Plag: 
0=not  continued 
1 =continued  to 
record  in  link 


Primitives 


II I ~^^if 
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GCSOPN  (oont.) 

note  that  for  devices  which  are  byte-oriented 
and  segmentation  Is  maintained  In  the  host-computer • 
the  device-dependent  segmentation  routines  for  the 
Tektronix  4014  probably  can  be -used  without 
modification. 


30 


GOSOOT ( ICOUNT , IBU? , IRBSP ) 

lOOUNT  indicates  the  number  of  ASCII  characters  to  be 
transmitted  to  the  display. 

IBU?  Is  the  buffer  containing  lOOUNT  ASCII  characters 
right- justified,  zero-fill. 

IR2SP  Is  a count  Indicating  the  number  of  acknowledge- 
ment characters  required  from  the  .terminal. 

This  Is  only  used  for  supporting  Intelligent 
devices. 

Comments:  This  Is  the  Interface  routine  between  GCS  and  the 
operating  system  routine  which  sends  characters  to 
the  terminal.  It  Is  called  by  all  GCS  routines 
which  need  to  transmit  to  the  display-device.  If 
ICOUNTsO,  the  operating  system  Is  requested  to 
flush  any  Internal  buffers. 

This  routine  cannot  bp  supported  at  the  display- 
device. 

Por  batch  device,  this  routine  performs  only  one 
function:  It  Intercepts  GCS  error  messages  and 
displays  them  on  the  system  print  file. 

Por  supporting  Intelligent  displays,  the  IRBSP 
argument  can  be  used  to  request  an  acknowledge- 
ment from  the  device  before  further  characters 
are  sent.  It  Is  usually  used  when  sending  functions 
which  may  require  a large  execution  time  at  the 
display. 

For  devices  without  Inherent  segmentation  capability, 
the  Initial  action  of  this  routine  should  be  to 
save  bytes  being  directed  to  the  plot  device  If  a 
segment  is  open.  This  is  acocompllshed  by  passing 
the  Input  to  device-dependent  routine  GCSPRM. 

When  a segment  Is  open,  the  bytes  are  only  directed 
to  the  display  surface  if  the  segment  Is  being 
constructed  visibly  (1.  e.,  the  open  segment  has 
visibility  attribute  of  "on").  If  no  segment  Is 
open,  the  bytes  are  always  directed  to  the  display 
surface. 
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GCSPEN(IX,IY,IZ,IPEN) 

1X,IY,IZ  is  the  end  point  of  the  line  to  be  drawn 

in  raster  units. 

IPEN  indicates  the  operation  to  be  performed. 

Zero  specifies  a move;  one  specifies  a 
line;  two  specifies  a point;  three  speci- 
fies a buffer  flush  request;  and  four 
specifies  a dashed  line. 

Comments:  This  routine  is  the  basic  drawing  routine  for 
each  device.  Several  variables  have  been  set 
aside  in  the  GSA  for  use  by  this  routine.  The 
array  KPCHAR  is  for  use  as  an  internal  work 
space  and  usually  is  where  the  command  to  be  sent 
to  the  display-device  is  constructed.  KPREVX, 
KPREVY,  and  KPREVZ  are  updated  with  the  value  of 
IX,  lY,  and  IZ  to  always  point  to  the  current  pen 
position  when  GCSPEN  terminates.  GCSPEN  may  also 
need  to  fetch  additional  information  to  insert 
intensity,  blink,  or  other  parameters  into  the 
command.  The  variable  KKMODE  is  updated  to  re- 
flect any  mode  changes  initiated  by  GCSPEN. 

If  the  display-device  is  such  that  a separate 
invisible  line  mode  is  used,  GCSPEN  will  set 
KMOVEF  to  one  whenever  he  will  exit  with  the 
display-device  primed  for  a blank  line.  Other- 
wise KMOVEF  is  set  to  zero  or  left  at  zero  which 
is  the  default. 

For  two-dimensional  devices,  the  IZ  and  KPREVZ 
variables  may  be  ignored. 

For  terminal  devices,  output  from  GCSPEN  is  sent 
through  GCSOUT.  For  batch  devices,  output  is 
written  on  the  appropriate  files  either  directly 
or  using  a device  specific  support  package. 

Note:  GCS  assumes  that  the  plotting  surface  is 
addressed  from  zero  to  some  maximum  positive  nvun- 
ber.  If  the  actual  address  range  contains  nega- 
tive numbers,  it  is  the  responsibility  of  GCSPEN 
to  add  in  the  appropriate  displacement  before 
building  the  display  processor  commands. 
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QCSPOS (ISEG , ILOCAI ) 

ISSG  is  the  number  of  the  segment  to  be  posted. 

ILOCAI  is  the  record  number  of  the  segment  location 
if  segmentation  is  maintained  in  the  host- 
computer. 

Comments:  This  routine  prepares  the  display  surface  for 

posting  a segment  and  also  posts  (i.e..  causes 
the  segment  to  be  displayed)  the  segment. 

ISBG  haveing  value  zero  indicates  a request  that 
the  display  surface  be  prepared  for  posting,  if 
required.  For  non-refresh  display  surfaces,  this 
indicates  a clearing  of  the  display  surface  in 
preparation  for  redrawing  the  retained  segments. 

For  refreshed  display  surfaces,  this  indicates 
that  all  non-re talned  information  (information  not 
in  retained  segments)  be  deleted.  In  either  case, 
when  all  segments  have  been  posted,  the  display 
surface  should  not  contain  any  information  prepared 
outside  of  retained  segments. 

If  ISSG  has  value  other  that  zero,  the  segment 
should  be  displayed  on  the  display  surface  it  its 
visibility  attribute  is  set  to  visible.  For 
displays  which  maintain  segmentation  at  the  device, 
no  action  should  be  required  since  the  display  of 
a segment  is  controlled  by  commands  from  GCS^C, 
GOSOPN,  or  GCSDBL.  If,  however,  the  host-computer 
maintains  the  segments,  the  segment  primitives 
must  be  copied  to  the  display  surface  (determination 
of  visibility  occurs  in  the  routine  which  calls 
GCSPOS ) . 

Note  that  for  byte-oriented  devices  with  no  inherent 
segmentation  capability,  the  Tektronix  A014  version 
should  be  usable  unmodified. 


i 


I 


33 


aCSPEM(  INCHI , INBU7 ) 

IHOHT  ts  tbt  number  of  bytes  of  Information  to  be 
Inserted  in  the  segment. 

IHBdF  is  the  buffer  containing  DTCITT  bytes  right- 
justified,  zero-fill. 

Comments:  This  routine  is  only  required  for  display  devices 

which  do  not  have  inherent  segmentation  capability. 
The  function  of  this  routine  is  to  receive  bytes 
from  GCSOUT  and  to  pach  the  bytes  into  the  segment 
which  is  saved  on  records  of  the  CCS  library  work 
file.  Bote  that  for  byte-oriented  devices,  the 
version  of  this  routine  in  the  Tektronix  4014 
library  should  be  usable  without  modification. 

If  the  input  to  GCSOUT  is  different  from  8-bits, 
this  will  require  that  during  execution  of  GCSPR21 
the  value  of  K3YTSL  should  be  set  to  the  appropriate 
value  and  the  value  of  ICPW  (in  GCSPRM)  should  be 
recomputed. 


GCSPST (OPTION) 


j OPTION  is  a standard  form  (four-charaotsrt  laft« 

j justified,  blanlc>fill)  UPS2T  option  name 

I passed  from  tJPSST. 

Comments:  This  routine  is  responsible  for  any  devioo* 
dependent  parameter  setting  required  by  the 
parent  UPSET  call. 

J 

I One  option  must  always  by  processed  in  GOSPST. 

! This  is  the  "SETSASH"  function*  If  the  Value 

i of  KDASHT  is  less  than  10,  this  indicates  that  a 

I hardware  dash  mode  is  requested.  The  value  9 

is  reserved  for  dotted  lines  and  1 through  8 for 
the  first  eight  hardware  dash  modes.  If  the 
display-device  does  not  support  hardware  dotted 
lines,  the  9 in  KDASHT  should  be  replaced  with 
944.  If  the  display-device  supports  less  than 
eight  hardware  dash  modes,  unsupported  dash  mode 
numbers  in  KDASHT  should  be  replaced  by  56. 

Other  UPSET  options  may  be  checked  for  as  required 
by  the  display-device  and  appropriate  action 
taken* 

This  function  cannot  be  supported  at  the  display- 
device*  However,  intelligent  devices  may  be 
passed  the  requested  setting  for  local  processing. 
Intelligent  display-devices  which  support  mode 
setting  will  require  a parallel  routine  to  receive 
the  requests  sent  by  GCSSET* 

The  setting  of  certain  hardware  attributes  should 
also  be  performed  In  this  routine.  These  are 
listed  below: 

SPACE  (devloe  or  virtual) 

PROJECTION 
WIDTH  of  lines 
BLINK  rate 
COLOR 

BRIGHTNESS  (intensity) 

SETDASH 

MARKER  selection 
LETTER  (character  type) 

CSPACING  (character  spacing) 

ANGLE  of  text  string 
SIZE  of  characters 
XSIZE  of  characters 
fSIZE  of  characters 
PONT 

ASPECT  RATIO 


GOSPXR  (XIH , TIN , Z in  ,XOTJT , TOUT , ZOOT ) 

XIN,TIN«ZIN  are  the  coordloatee  of  the  head 
endpoint  of  the  line  in  viewing 
coorinatea. 

XOUT,TOUT,ZOUT  are  the  coordinates  of  the  head  end 

of  the  visible  portion  of  the  line  in 
viewing  coordinates. 

Comments:  This  routine  provides  general  clipping  to  the 
viewing  pyramid  for  those  display-devices  in 
which  the  3-D  clipping  functions  is  not  performed 
at  the  display-device.  The  algorithm  provided 
is  that  of  Sutherland  and  Cohen  as  published 
Principles  of  Interactive  Graphics  by  Newman  and 
Sproull. 

For  three-dimensional  devices  which  perform  the 
3-D  clipping  function  at  the  display-device, 
this  routine  whould  set  KPTRCP  = -1  indicating 
that  no  clipping  took  place  and  then  copy  the  input 
arguments  into  the  output  arguments. 

This  routine  can  only  be  supported  in  the  display- 
device  if  the  following  conditions  hold: 

1 ) a cllpplng/dlvlder  is  provided  in  the 
hardware  or  the  Suthsrland-Cohen  algo- 
rithm is  implemented  in  the  display- 
device  mini-computer. 

i 

2}  GCSMA.P  is  also  supported  at  the  display- 
device. 

Although  it  is  theoretically  unnecessary  for 
viewing  transformations  to  be  supported  at  the 
display-device,  most  devices  which  support  3-D 
clipping  also  support  the  viewing  transformation 
in  rotational  hardware. 


If 
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aCSHNH(NAMOLS  .NAMNSif ) 

NAMOLS  Is  the  number  of  a ourrentlf  existing  segment. 

UAHNSVf  Is  the  nev  number  tj  which  the  segment  referred 
to  in  NAJfOLS  will  henceforth  be  called. 

Comments:  This  routine  renames  a segment.  It  is  a null 

routine  if  segmentation  is  maintained  within  the 
host-computer. 

For  display  devices  which  maintain  segmentation 
at  the  device,  the  old  name  and  new  name  are  sent 
to  the  display  device  where  the  name  change  takes 
place. 
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GOSVPT 

Oomments:  This  routine  transmits  the  viewport  dimensions 
and  position  relative  to  the  vlewpolnt/vlewslte 
to  the  display  device.  For  all  devices  which  do 
not  support  viewing  transformations  at  the 
display,  this  operation  Is  null. 


G03VTD (XIH, YIM ,ZIH , IXOUT , lYODT , IZODT ) 

XISdlN.ZIN  contalzia  th«  input  coordinates  in 

viewizig  space  units  after 
clipping  and  projection. 

IXOUT, lYOUTflZOlTT  contains  the  output  coordinates 

in  device  raster  units. 

Oofflinents:  For  2-D  devices  or  3-*U  devices  without  clipping 

at  the  device,  this  routine  accepts  input  virtual 
viewing  space  units  on  the  projection  plane  and 
converts  them  to  device  units  after  clipping  at 
the  UWINUO  boundaries.  For  these  devices,  a 
routine  is  provided. 

For  3-S  devices  with  clipping  at  the  device,  this 
routine  accepts  input  virtual  viewing  space  units 
and  converts  them  to  3-U  device  units  without  any 
clipping  operation. 

The  clipping  function  of  this  routine  can  be  sup- 
ported at  the  display.  This  requires  that  the 
window  definition  be  sent  to  the  display  by 
GCSUSF  and  GCSVfUO. 


Gosvm) 


Comments:  This  routine  transmits  the  viewing  veotor  sped- 
floatlons  to  the  display-device  If  viewing  trans- 
forms are  to  be  applied  at  the  display-device* 

?or  2-D  devices  and  devices  without  a local 
view  transformatlony  the  location  of  the  view 
point  and  the  view  site  or  the  view  point  and 
the  direction  cosines  are  sent  In  display- 
device  units. 
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GOSVUS (XOBJ , lOBJ ,ZOBJ ,XSYS , IBYB , ZBIX } 

XOBJ (YOBJ ,ZOBJ  contain <th«  input  coordinates  in  object 
space  units. 

XSrB.TBXS.ZSIS  vill  recsive  ths  output  coordinates  in 
▼isiring  coordinate  units. 

Oooasnts:  This  routine  conrerts  objsot  spaoe  coordinates  to 
view  spaoe  coordinates if  this  function  is  to  be 
performed  in  the  host-oomputer.  For  devices 
and  3~0  devices  without  local  viewing  transformation 
capability,  this  routine  applies  the  viewing  trans- 
formation. For  3**0  devices  with  local  viewing 
transformation  capability,  this  routine  simply 
copies  the  input  coordinates  into  the  output  coordi- 
nates. Hots  that  if  viewing  transformation  is  to 
be  applied  at  the  display-device,  the  following 
functions  must  also  be  performed  at  the  display- 
device:  3-D  clipping,  projection,  and  windowing. 


Ui 
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GOSVDO 


aommenta:  This  routlna  transslta  ths  window  boundarlas  to  the 
dlsplay-derlee.  If  required.  7or  2~D  derloea  and 
3-D  dewlees  without  a looal  aolaaorlng  facility, 
this  routine  la  null.  Tor  3-0  dewloes  with  a 
looal  solssor  facility,  this  routine  transmits  the 
boundary  apeolfleatlons  In  view  apace  units  to  the 
terminal. 
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GCSWHR(IX,IT,IC) 

IX,I7  will  oontain  the  raster  unit  coordinates  of  the 
Input  cursor  position. 

10  Is  a modst  status,  or  option  character  obtained 
during  the  Input  operation.  If  10  s 0 upon 
^ entry  to  GOSWHR,  only  the  character  Is  requested. 

OoBunents:  This  routine  performs  **po8ltlonlng*'-type  Input 
operations  from  the  Input  device  specified  by 
GSA  variable  EGIN  or  the  closest  available 
equivalent.  Whatever  the  form  of  the  Input  coordi- 
nates when  received,  they  must  be  converted  to 
standard  raster  unit  format.  The  mode,  status,  or 
option  character  should  be  converted  to  a form 
which  can  be  Identified  by  comparison  with  a 
Hollerith  string. 

This  routine  cannot  be  supported  at  the  display 
but  may  require  a parallel  function  to  execute  In 
an  Intelligent  device. 


IV,  Guidelines  for  Intelligent  Devlcea. 


Display-devices  which  have  computing  poser  of  their  own 
may  be  termed  Intelligent.  Appropriate  use  of  this  Intel- 
ligence can  greatly  Increase  the  capabilities  of  the  entire 
system.  Most  suoh  display-devices  have  a refresh  capability. 
Thus,  much  of  the  capaolty  of  the  general  processor  of  the 
device  Is  Involved  with  display  list  management. 

In  GOS,  a display  list  management  facility  has  been 
provided  to  support  dynamic  pictures  In  a device-independent 
manner  to  the  extent  that  the  program  will  execute  correctly 
even  while  using  dynamic  Instructions  on  a non-refresh  device. 
This  Is  the  segmentation  facility.  A complete  name  for  this 
feature  Is  transformed,  segmented,  unstructured  display  list. 
Several  functions  are  available  In  GCS  to  create,  manipulate, 
and  delete  segments.  Segments  are  "opened"  with  a UOFM 
(UPRAMS)  funotlon  and  are  closed  with  a UCLOSB  (UPRBND) 
fvmctlon.  Associated  with  each  segment  are  attributes  which 
may  be  modified  by  the  DMODPY  routine  and  by  the  Image  trans- 
formation routines  UIMAGB,  U3IMAG,  UPLACS,  and  U3PLAC.  Seg- 
ments may  be  deleted  with  the  UDBLBT  function.  All  segments 
can  be  deleted  with  the  UDSLAL  function.  Associated  with 
these  user-callable  routines  are  several  device-dependent 
system  routines  which  either  simulate  the  functions  or  send 
the  requests  to  the  display-device.  These  are  GCSCLS, 

GCSDEL,  GCSMOD,  GCSOPN,  GCSPOS,  GCSPRM,  and  GCSRNM. 

In  the  display,  a nOPSN  (UPRAME)  operation  starts  up  a 
new  segment  for  the  Indicated  segment  name.  If  a segment 
for  that  name  already  exists,  a double  buffering  takes  place 
which  continues  showing  the  elder  of  the  two  segments  with 
Identical  numbers  until  the  newer  segment  definition  Is 
complete  (Indicated  by  receiving  a UOLOSS  (UPRSND)  command). 

At  this  time,  the  elder  segment  Is  deleted  and  the  newer 
segment  Is  displayed  (If  visible).  Since  the  double  buffering 
If  performed  entirely  by  the  device-independent  routines. 

It  need  not  be  supported  at  the  display  device.  If  a segment 
Is  constructed  visibly.  It  will  be  shown  when  completed.  It 
can  then  be  made  Invisible  by  executing  a UMODPY  (GNSHOW) 
command.  If  a segment  Is  constructed  Invisibly,  It  will  not 
be  displayed  until  a 'JMODPY  (USHOW)  command  Is  received 
making  It  visible.  Subsequent  UMODPY  commands  can  make  any 
segment  visible  or  Invisible  as  required. 

The  logical  organization  of  the  display  list  Is  as  above. 
The  actual  physical  crganlzatlon  and  technique  of  memory 
management  will  depend  on  the  particular  display-device. 

In  addition  to  display  list  management  routines,  the 
Intelligent  device  general  prccessor  will  also  need  to 
Interface  available  hardware  functions  with  the  device- 
dependent  routines  of  GCS  and  to  provide  simulators  as 
desired  for  device-dependent  functions  not  available  In  the 
particular  hardware  under  consideration. 
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la  dtalgnlog  the  format  in  which  the  device-dependent 
GCS  routines  communicate  with  the  display-device,  It  Is 
wise  to  select  an  encoding  scheme  that  does  not  violate 
ASCII  coding  oonvsntloBs.  This  requires  that  only  seven 
bite  be  used  as  data  and  the  parlty-blt  reserved  for 
parity  or  marking  oven  If  the  particular  operating  system 
does  not  require  It.  Following  this  procedure  will  allow 
connection  of  the  terminal  with  the  host-computer  over  - 
standard  communication  lines  without  speolall  communications 
software. 

In  selecting  which  functions  should  be  simulated  In  an 
Intelligent  3>S  display-device  or  whether  a particular 
hardware  fvmctlon  should  be  utilized,  the  following  table 
may  be  of  use.  For  correct  operation  of  3-^  functions, 
the  cut-off  In  the  list  of  functions  should  be  as  close  to 
the  top  as  possible  always  remembering  that  all  functions 
below  the  topmost  function  to  be  Implemented  In  the  display- 
device  must  also  be  Implemented  In  the  display-device. 

Curve  Generation 
Viewing  Transformation 
3-S  Clipping 

Projection  (Perspective  or  Orthogonal) 

Vflnd  owing 

Hardware  Character  Generation 
Hardware  Dashed  Line  Processing 
Vector  Drawing 


I GCS  Is  a modular  system.  Since  many  of  the  devices 

I supported  by  GOS  are  relatively  unsophisticated,  many  of 

I the  GCS  devlce>dspendent  libraries  contain  simulators  for 


many  of  the  hardware  functions.  By  using  these  simulators, 
it  Is  possible  to  shorten  the  Initial  Implementation  time 
for  new  devices  allowing  later  replacement  of  the  simulators 
as  time  permits  and  as  required  by  the  display-device 
capabilities. 

rhe  following  scheme  for  phased  Implementation  of  new 
devices  has  been  designed  to  maximize  the  benefits  mentioned 
above. 

Phase  1 : Identify  the  required  Initialization  values  for 

each  device-dependent  GSA  variable  and  Insert  them 
In  the  Block  Data  and  UHSSST  subroutines. 

Phase  2:  ?or  Intelligent  devices,  design  the  communications 

data  structures  to  be  used  between  the  device-dependent 
GCS  routines  and  the  program  executing  in  the  display- 
de''  ce.  This  program  should  be  developed  in  parallel 
to  .he  device-dependent  GCS  routines  in  the  remaining 
phases  if  not  already  available. 

Phase  3:  Implement  the  GCSBBG,  GCSFST,  and  GCSMD  functions. 

If  necessary.  For  3-D  devices  with  viewing  transform 
capability,  this  may  require  Initializing  the 
transform  matrix  to  the  GCS  default. 

Phase  4;  Implement  the  GCSSRA,  GCSPEN,  GOSVUE,  GC3VUD,  GCSVPT, 
GOSVTD,  GGSDSP,  GCSWDO,  GCSPYK,  and  GCSMAP  routines. 
Note  that  for  2-D  devices  and  3-D  devices  with  no 
local  viewing  transform  capability,  the  GC3VUE,  , 
GOSVUD,  GCSVPT,  GCSPYH,  and  GCSMAP  routines  already 
exist  and  may  be  used  unmodified.  The  GCSVTD,  GCSWDO, 
and  GCSDSP  routines  should  also  be  used  unmodified 
for  these  devices  even  If  windowing  Is  available  at 
the  device  during  the  first  Iteration.  The  GCSOUT 
routine  can  usually  be  used  without  modification 
from  one  of  the  other  libraries.  Simulator  or  null 
routines  can  be  used  for  the  remaining  functions. 

Phase  5s  Implement  the  GCSALP  routine  If  a hardware  character 
generator  Is  available.  This  would  replace  the 
hardware  character  simulator  accessing  version  of 
GCSALP. 

Phase  6:  Implement  the  segmentation  routines,  if  the  device 
has  an  inherent  segmentation  capability.  If  not, 
the  simulator  version  of  these  routines  is 
appropriate. 
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Phase  7:  Implement  the  aosiHt  GCSIHH,  and  GCSWHR  routines 
if  the  device  Is  Interactive.  These  would  then 
replace  the  null  routines  irtilch  probablj  were  used 
until  this  phase. 

Phase  8:  Implement  all  other  functions  irtiloh  do  not  yet 
support  the  capabilities  of  the  device. 

By  following  the  sequence  above*  experience  has  shown  that 

Implementation  of  new  devices  should  proceed  smoothly. 


In  accordance  with  letter  from  DAEN-RDC,  DAEN-ASI  dated 
22  July  1977,  Subject:  Facsimile  Catalog  Cards  for 
Laboratory  Technical  Publications,  a facsimile  catalog 
card  in  Library  of  Congress  MARC  format  is  reproduced 
below. 


Puk,  Richard  F 

Device  implementation  guidelines  for  the  three-dimensional 
Graphics  Compatibility  System  (GCS)  / by  Richard  F.  Puk, 
Albuquerque,  N.  Mex.  Vicksburg,  Miss.  : U.  S.  Waterways  Ex- 
periment Station  ; Springfield,  Va.  : available  from  National 
Technical  Information  Service,  1979. 

47  p.  ; 27  cm.  (Miscellaneous  paper  - U.  S.  Array  Engineer 
Waterways  Experiment  Station  ; 0-79-2) 

Prepared  for  Office,  Chief  of  Engineers,  U.  S.  Army,  Wash- 
ington, D.  C.,  under  Contract  No.  DACA39-78-M-0053. 

1.  Computer  graphics.  2.  Graphic  arts.  3.  Graphics  Compati- 
bility System.  4.  Guidelines.  I.  United  States.  Army.  Corps 
of  Engineers.  II.  Series:  United  States.  Waterways  Experiment 
Station,  Vicksburg,  Miss.  Miscellaneous  paper  ; 0-79-2. 
TA7.W34m  no. 0-79-2 


WATERWAYS  EXPERIMENT  STATION 
REPORTS  PUBUSHED  ON  THE 
GRAPHICS  COMPATIBILITY  SYSTEM 


Utle 


Misc«nan«ous  Paper  0-79-1 
MiacaOanaotJS  Paper  0-79-2 
Miscaiianaous  Paper  0-79-3 


Host-Computer  Impiamantation  Guidetinas  for  the  Threa- 
Obnansional  Graphics  Compatibility  System  (GCS) 

Davica  Impiamarttation  Gukfalinas  for  the  Threa- 
Dimansiortal  Graphics  Compatibility  System  (GCS) 

Raster  Graphics  Extensions  to  the  Graphics  Compatibility 
System  (GCS) 


Date 

Mar  1979 

Mar  1 979 

Mar  1979 


